Use the Dialog Dismisser Utility

Dialog Dismisser is a utility that can be started/stopped via the Tools menu in eCapture QC. (This also runs behind the scenes during Discovery, Process, and Data Extract Jobs in the Worker.) When started during QC, it checks for specific dialogs and sends Windows messages to clear them. This utility assists in preventing application dialogs from stopping EDD operations in order to wait for user input. The Dialog Dismisser takes the process ID of the program that launched it as a parameter and will terminate itself if that process terminates.

Note: Some messages cannot be dismissed with this utility depending on their source and handle.

Signatures and Targets

Signatures for target dialogs are created during configuration. A signature includes the:

• full or partial caption of the target dialog
• full or partial caption of a child window of the dialog
• count of child window objects divided into buttons, statics (labels), and other child windows.

All these criteria must be met before the dialog is identified as a target. Once a target dialog has been identified, a dismiss action is selected: either a WM_CLOSE message is sent or a specific button (selected from a drop-down box) is clicked.

There are configuration file options for how often the Dialog Dismisser checks for dialogs/windows and for how often the Dialog Dismisser reloads the signatures and settings from the configuration file. This allows on-the-fly configuration changes without having to stop and restart QCing.

Locate the Dialog/Window for Signature Configuration

1. Double click the file, DialogDismisser.exe, located in the eCapture Worker subdirectory. The Signature Creator dialog appears.

   

2. Before beginning to configure a signature, ensure that the dialog/window is open. The Dialog Dismisser attempts to locate the dialog/window to be configured for a signature.

3. In the Find Dialog section, select the appropriate options:

   • Dialog caption - defines the dialog/window caption to look for. Exact matches are case-sensitive. The other types are: Begins With, Ends With, and Contains.
   • Identifying text in child window - defines text that exists in at least one child window. Exact matches are case-sensitive. The other types are: Begins With, Ends With, and Contains.
   • : Attempts to locate the opened dialog/window for signature configuration. It may be necessary to try different combination identifiers in order to successfully locate a dialog/window. When successful, the Signature Creator dialog box expands to include additional options. For more information on creating a signature, see Create a Signature.
   • : Clears the Find dialog controls (Dialog caption and Identifying text in child window)

4. In the Existing Signature section, select the appropriate options:

   • : Loads the selected signature criteria (Dialog caption and the Identifying text in child window fields) for editing. The types in the drop-down box are also loaded. An example follows for an existing signature.

     

   • : Removes the selected signature from the in-memory list.

     A removed signature can be restored by editing the DismissDefs.INI file manually. This file is located in the Worker subdirectory. The [Definition List] shows the number of definitions in the file and the name of each definition; e.g. Definition4=Word Print margin

     Each individual definition is listed separately below the [Definition List]. An example follows:

     [Word Print margins]

     FindCaption=Microsoft Office Word

     FindMethod=1

     FindChildCaption=The margins of section

     FindChildMethod=2

     RecursionLevel=1

     Buttons=2

     Statics=1

     Others=1

     Action=Click:&Yes

5. Check Interval: Defines the length of time between checks the Dialog Dismisser should remain idle. Select an interval from the drop-down box: 1, 3, 5, 10, 30 seconds (default), 1, 2, 5, 10 minutes, Never.

6. Reload from INI file: The number of dialog/window check iterations between reloading signatures and settings from the definition file. Select an iteration from the drop-down box: Every check, Every 3rd check, Every 5th check, Every 10th check, Never.

7. : Writes all signatures (new and edited) in memory to the configuration file (.INI). It overwrites existing settings for like-named signatures, but will ignore signatures that are not like-named.

Create a Signature

The Signature Creator dialog expands to include additional options after the open dialog/window is successfully located based on the entered criteria.

The additional options indicate “Found window with caption (dialog/window caption text appears here followed by a handle value).

• Control signature: This box shows the count of window objects: buttons, statics (labels) and other child windows
• Dismiss Action: Select one of the following:
  • Send WM_Close
  • Click button - select an action from the drop-down box.
• : Used to test the desired dismiss action. This will send the same commands during QC when reprocessing.
• If the test is successful, click to write the signature to the in-memory list. To save the information to the configuration file, click .